home *** CD-ROM | disk | FTP | other *** search
/ Network Supervisor's Toolkit / Network Supervisor's Toolkit.iso / printers / q-view / qview.doc next >
Text File  |  1996-07-10  |  12KB  |  304 lines
  1. QView:  Multiple print queue monitor program    v1.4
  2.         Copyright (c) 1992   All rights reserved
  3.  
  4.         by: Stephen Herzog
  5.             herzogs@ucs.orst.edu
  6.             herzogs@prism.cs.orst.edu
  7.  
  8. ABSTRACT:
  9.  
  10. QView is a small Novell utility that will display up to 21
  11. print queues and monitor for duplicate print jobs.  QView
  12. can be configured to display only some queues, or it can 
  13. seek all queues available.  When QView is given queue 
  14. operator rights, it can be configured to delete duplicate 
  15. print jobs.  QView will also notify the user when a file is 
  16. deleted and if desired, notify a consultant or other 
  17. designated user as specified in the QView.ini file.
  18. QView can also keep a log file of all printing activity.
  19.  
  20. QView was written to be used on a low end IBM computer.  
  21. However it will work on any speed machine.  The display is 
  22. in ASCII characters, so all monitor types are compatible 
  23. with QView.
  24.  
  25. The most productive use of this program is to place a 
  26. dedicated machine next to a printer bay and allow QView to 
  27. run constantly.  Users will be able to see at glance where 
  28. their jobs are in the print queue.  
  29.  
  30. I originally wrote this program to be placed next to 12 
  31. printers to ward off a few hundred questions from students 
  32. who had "lost" their printouts and were printing duplicate 
  33. copies while waiting for the print jobs to be spooled by the 
  34. servers, something that can take a while on a busy network.
  35.  
  36. One of QView's major advantages is that it will also monitor 
  37. the print queue for duplicate jobs.  When a user prints, and 
  38. it does not pop out of the printer immediately they 
  39. sometimes print again, without waiting.  Only the oldest 
  40. non-active job will be deleted.  This helps to ensure that 
  41. if the user makes a change, or switches printers that it 
  42. would not delete the updated print job.  When a user prints 
  43. a duplicate job to another queue, the first one they sent 
  44. will be deleted and thus, the most recent copy is left.  One 
  45. thing to note is that active and loading jobs are not 
  46. tampered with.  The "duplicate" status only occurs when the 
  47. job owner, banner, station, and file size are all the same 
  48. between two jobs in any queues at the same time.
  49.  
  50. Another major advantage of QView is the oversize job delete 
  51. function.  When configured, QView will delete all print jobs
  52. over a specified range.  Again, QView will not delete active
  53. or loading jobs.
  54.  
  55. WHAT'S NEW:
  56.  
  57. Since the First release,(v1.1b) I have added a few features, and 
  58. fixed a few problems.  
  59.  
  60. *    An option to delete oversized jobs has been added.  
  61.     Use with care.  Jobsize does not reflect number of pages.  
  62.     A graphics print job can be up to 1/2 meg per page, 
  63.     when a page of text may only be 1k in size.  PostScript
  64.     is also much larger than ASCII text.
  65.  
  66. *    Originally, QView would display only the banner name 
  67.     from the print job owner.  Some applications do not 
  68.     send a banner name, so the line on the screen was left
  69.     blank.  QView now substitutes the username if the banner
  70.     name is blank.
  71.  
  72. *    The first release of QView had a compatibility problem 
  73.     NW 3.11.  This has been fixed.  The symptoms were 
  74.     random lockups of the workstation running QView.
  75.  
  76. Since the second release,(v1.2) I have fixed the following problem.
  77.  
  78. *    Qview exited if there was more than 21 jobs waiting in 
  79.     any of the print queues that Qview was monitoring.  Qview
  80.     will only monitor the first 21 jobs in a queue.  If more 
  81.     than 21 jobs are in a queue, the ones over 21 will not be
  82.     watched for duplicates.
  83.  
  84. Since the last release,(v1.3) I have added the following.
  85.  
  86. *    Qview now exits with a dos errorlevel equal to that of the
  87.     current hour.  e.g. if QView exits at 5pm it will have a 
  88.     dos errorlevel of 17.  This can be used for machines that use
  89.     the cycleing feature.  set QView's run time to 30 minutes, and
  90.     check for an errorlevel of 4 and then your batch file can do 
  91.     a special process at 4am.
  92.  
  93. *     QView can be configured to show the job owner name or the banner
  94.     name.  This is useful for some windows applications.
  95.  
  96. *     Jobs that have been in the queue too long can be removed.  You 
  97.     may specify an age (minutes) that a job will be removed.
  98.  
  99. *    QView now has a Log File option.  This is useful for monitoring 
  100.     all the printing activity of your printers.  The log file will
  101.     record the job owner, banner, size, date, time, queue, server, and
  102.     job number for every job, and it will add an additional line for 
  103.     jobs that are deleted by QView with a reason for deletion.  If
  104.     your QView exits, it will re-log all the jobs that are currently
  105.     in the queue.  You should look at the file very carefully before
  106.     you start charging people for printing.  The file also has some
  107.     nul (ASCII 0) characters in it.  Some word processors will
  108.     choke on this.  Use a search and replace to remove these.
  109.  
  110.     PLEASE NOTE:  This does not count pages, only file size in bytes.
  111.  
  112. Future improvements:
  113.  
  114. *    I have a future version that will allow Macintosh workstations
  115.     to print to a HPIIIsi PostScript printer.  This works very well, 
  116.     and is very fast.  This should work with any PostScript printer, 
  117.     however I have not had the opportunity to try it on anything but 
  118.     the HP.  Our setup includes Novell 2.15c and ver 2.0 of the 
  119.     Dayna Appletalk Print Gateway.  The Print Queue is created with 
  120.     the MacSetup Program, and then the HPIIIsi is allowed to service 
  121.     the queue.  Qview monitors for APPLETALK jobs, and prepends the 
  122.     Macintosh MD dictionary to the beginning of the print job. 
  123.     IBM jobs are not tampered with.  The HPs also continue to 
  124.     do language switching.  This would allow the machines to print 
  125.     banner pages as well.
  126.     
  127.     This release(v1.4) does not have this option.   If enough people
  128.     want this option, I will add it in, and release a new version.
  129.  
  130.  
  131. THE SYMBOLS:
  132.  
  133. When QView is running it has several status symbols next to 
  134. the displayed user name (banner name).  These are listed below.
  135.  
  136. (spinning slash)        Active.  Sending document to printer.
  137.  
  138. (expanding = )            Loading and the file size is changing.
  139.  
  140. R                Ready and waiting for printer.
  141.  
  142. L                Loading, but file size is unchanged.
  143.  
  144. H                Holding (by operator or user)
  145.  
  146. The displayed user name is the banner name for the print job.  
  147. Macintosh machines will show the name from the chooser window 
  148. in the banner name.  All macintosh print jobs have a username of 
  149. APPLETALK however, the banner name will reflect the individual 
  150. workstation that sent the job.  If the banner name field is empty, 
  151. the print job owner name is substituted.
  152.  
  153. The print job size will be displayed to the right of the 
  154. job owner if there is room. 
  155.  
  156. Once QView is running you may press ESC to quit.  No other 
  157. keystrokes will have any affect.
  158.  
  159. SETUP:
  160.  
  161. QView can be configured using a file named QVIEW.INI   An 
  162. example file is shown below.  Save this with an ascii file 
  163. in the search path.  If you want only the default values, 
  164. delete the sample qview.ini file provided.
  165.  
  166. * Note:    Commands must be in the order shown below, or 
  167.         completely omitted.
  168.  
  169.  
  170.  
  171. Clobber
  172. Chastise
  173. Notify CONSULTANT
  174. MaxJobs 10
  175. LogFile f:\lab\meter\printing.log
  176. Jobsize 2000000
  177. Age 30
  178. Owner
  179. runtime 5
  180. speed 7
  181. Display queues
  182. kerrlab3 1apple1queue
  183. kerrlab3 2apple2queue
  184. kerrlab3 3apple3queue
  185. kerrlab3 4apple4queue
  186. kerrlab2 5apple5queue
  187. kerrlab2 6apple6queue
  188. kerrlab2 7apple7queue
  189. kerrlab2 printq_0
  190. kerrlab1 printq_2
  191. kerrlab1 printq_3
  192. Kerrlab3 printq_8
  193. kerrlab3 printq_9
  194.  
  195.  
  196.  
  197. All of the commands are defined below.  As noted, this software 
  198. is a bit picky about this file, so the file must be entered 
  199. without any typing errors.  No extra spaces at the end of 
  200. the line, or in the middle, and the commands must be left in 
  201. the order you see.  You may omit commands, just do not 
  202. rearrange the order.
  203.  
  204. CLOBBER        Delete all found duplicate jobs.  Omit this line 
  205.         to prevent this deleting. Default is off
  206.  
  207. CHASTISE    Send a warning to users telling them that they 
  208.         shouldn't print multiple print jobs.  (Only if 
  209.         notify is on)  Default is off
  210.  
  211. NOTIFY        Send a message to a user stating a duplicate or
  212.         oversize has been found.  Useful for lab 
  213.         monitors (consultants)
  214.  
  215. MAXJOBS        After x jobs are in the queue, send a message to 
  216.         a user (CONSULTANT) specified by NOTIFY about the 
  217.         queue status.  Also, it turns the queue window red.  
  218.         Default is 15
  219.  
  220. LOGFILE        Keep a log file of all printing activity. This file is
  221.         opened only for writing, so you can copy it from a network
  222.         drive, but QView will not write to it when it is open.
  223.  
  224. JOBSIZE         Delete all print jobs over x size (in bytes)
  225.         if CLOBBER is on.  If CLOBBER is off, just notify
  226.         the user about the oversize job.  Default is 
  227.         off.
  228.  
  229. AGE        After a job is x minutes old it will be removed if
  230.         CLOBBER is on. 
  231.  
  232. OWNER        Force Qview to display the job's owner login name
  233.         and not the banner. 
  234.  
  235. RUNTIME        Run for x minutes before exiting.  This is useful 
  236.         for dedicated machines.  Ours is set to exit every 
  237.         5 minutes and delete temp files from a directory.  
  238.         Have a cycling batch file to call qview, and your 
  239.         other program alternately.  Default is 100 
  240.         minutes before exiting
  241.  
  242. SPEED        Controls how fast the QView queries the servers.  
  243.         Speed varies form 1 to 10.  10 being fastest.  
  244.         Increased speed increases accuracy, but degrades 
  245.         performance of the servers.  Default is 10 
  246.         (fastest)
  247.  
  248. DISPLAY QUEUES  Display the following list of print queues.  
  249.         format is SERVERNAME QUEUENAME as shown above.  
  250.         If no queues are specified, or the DISPLAY QUEUES
  251.         line is omitted, QView will seek all available 
  252.         print queues.
  253.  
  254. This is the third release of this program.  Hopefully, I have
  255. removed all the problems now.   If you register your copy, 
  256. I will be sure to notify you as improvements are made 
  257. and bugs are fixed.  Registered users are also entitled to free 
  258. upgrades.  (Such as Macintosh Printing to HPIIIsi printers)
  259.  
  260. As noted, I would like to hear any input anyone has on this 
  261. program.  You may reach me at the following Email or USmail 
  262. addresses.   (see end of file)
  263.  
  264. Please Note:  
  265.     I currently a student at Oregon State University.
  266.     The University is in no way related to this program, 
  267.     so please refer all questions to me, and not the University.
  268.     They have been gracious enough to allow me to distribute
  269.     this program through their internet access in exchange for
  270.     a site registration for the program.
  271.  
  272. ShareWare ***
  273.  
  274. I am asking a $25 (US Dollars) fee for this software to 
  275. compensate for my time and resources I used to write this 
  276. program.  About 150 hours were invested in this project.  I 
  277. have several other projects that are on the back burner now, 
  278. but if this venture proves to be worth my effort, I will be 
  279. inclined to release the other programs I am working on as 
  280. well.  After all, think of how many user's questions this 
  281. will answer at the glance of a monitor.
  282.  
  283. NagWare ***
  284.  
  285. In the 6 months that this program has been out, I have received over 
  286. 200 suggestions, requests, complaints, and questions, but I have only
  287. had 2 people register this software.  With this in mind I have added 
  288. a gentle reminder to register this software.  Once registered, I will
  289. send you a personalized patch to make this go away.  The reminder will
  290. not affect the functionality of this program.  
  291.  
  292. FTP sites are not to publish this patch with this software.  
  293.  
  294. Send all questions, comments, or registration fees to:
  295.  
  296. Stephen Herzog
  297.  
  298. 3930 Witham Hill Dr. Apt 147-P
  299. Corvallis, OR 97330 USA
  300. (503) - 758 - 0955
  301.  
  302. herzogs@ucs.orst.edu
  303. herzogs@prism.cs.orst.edu
  304.